Skip to main content
Version: V12

Publish Mashup Tool

Use the Publish Mashup tool to enable AI-powered workflows to publish content through the VIDIZMO platform. When you connect this tool to an AI node, the AI model can dynamically publish mashup content based on user requests and workflow context.

In this article, you learn how to add, configure, and test the Publish Mashup tool in your workflow.

Concept​

The Publish Mashup tool is a VIDIZMO-specific tool node that provides AI models with the ability to publish content through the VIDIZMO platform APIs. Unlike regular workflow nodes that execute in sequence, this tool is invoked by an AI node only when the model determines that content publishing is needed.

Key capabilities:

  • Content publishing - Publish mashup content through the VIDIZMO platform APIs
  • Field validation - Validate required fields before attempting to publish
  • Status reporting - Return publish status and relevant metadata including mashup ID and URL
  • Permission enforcement - Respect publishing permissions and tenant isolation

Understand how the tool works​

This section explains how the Publish Mashup tool operates within a workflow and how it connects to other nodes.

Tool connectors​

In the Workflow Designer, nodes use colored connectors to indicate the type of connection and data flow. The Publish Mashup tool uses the green connector, which is specific to tool nodes.

Execution flow​

When a workflow runs, the Publish Mashup tool operates in this sequence:

  1. The AI node receives user input from the chatbot.
  2. The AI model analyzes the input and determines whether content publishing is needed.
  3. If publishing is needed, the AI invokes the Publish Mashup tool through the green connector.
  4. The tool validates required fields and sends a publish request to the VIDIZMO API using the user's authentication context.
  5. The VIDIZMO API processes the publish request and returns the result.
  6. Publish status and metadata are stored in the field specified in Output Field.
  7. The AI node accesses the result and confirms the publish action to the user.
┌─────────────┐      ┌─────────────┐      ┌──────────────────┐      ┌──────────────┐
│ User Query  │ ───► │  AI Node    │ ───► │ Publish Mashup   │ ───► │ VIDIZMO API  │
└─────────────┘      └─────────────┘      │ (Green Connector)│      └──────────────┘
                            ▲              └──────────────────┘             │
                            │                                               │
                            └── state.data.publish_result ◄─────────────────┘

When to use this tool​

Use the Publish Mashup tool when your workflow requires:

  • AI-driven content publishing based on natural language requests
  • Publishing drafted content that users identify through conversation
  • Automated publish actions as part of a content management workflow
  • Confirmation-based publishing where the AI verifies intent before executing

Add the Publish Mashup tool to your workflow​

Follow these steps to add the Publish Mashup tool to your workflow canvas.

  1. Go to Portal Settings > Chatbot > Workflow.

  2. Select an existing workflow or create a new workflow.

  3. In the Node Library, expand the Tools category.

  4. Drag Publish Mashup Tool onto the canvas.

Connect the tool to an AI node​

After you add the Publish Mashup tool to the canvas, connect it to an AI node.

  1. Locate your AI node (such as an LLM node) on the canvas.

  2. Drag a connection line from the green connector to the input connector on the Publish Mashup tool node.

  3. Release to create the connection. A green connector (●) indicates a successful tool connection.

NOTE: The green connector indicates that the tool is available to the AI node for on-demand invocation. The tool doesn't execute in sequence with other nodes, it executes only when the AI model decides to invoke it.

Configure the Publish Mashup tool​

Select the Publish Mashup node to open the Node Configuration Panel. You can configure the following options:

Description​

Instructions for the LLM on how and when to use this tool. The default description provides guidance including:

  • When to invoke publishing (user requests to publish content, confirms a publish action)
  • Required fields and validation rules
  • How to confirm user intent before publishing

The AI uses this description to determine when publishing is appropriate. For example, when a user says "Publish the training video I just uploaded," the AI reads the description to understand it should invoke the Publish Mashup tool with the content's identifier.

TIP: Keep the default description unless you need to customize the AI's publishing behavior for specific use cases. Consider adding instructions to always confirm with the user before publishing.

Publish parameters​

You can configure the following options:

  • Mashup ID: The unique numeric identifier of the content item to publish. The AI typically populates this from search results, user-selected content, or conversation context. Enter a fixed ID such as 12345 for testing, or use ${state.data.target_mashup_id} to reference a dynamically determined ID.

  • Body: An optional JSON object containing additional mashup information fields to include in the publish request. Use this when the user wants to update content metadata such as title, description, or tags during publishing. When left empty, the content is published with its existing metadata. Enter a JSON object or use ${state.data.publish_body} for dynamic values.

All publish parameters support Fixed (static value) and Expression (dynamic value using ${variable} syntax) input modes.

Output settings​

  • Output Field: Variable name where the publish result is stored for use by other nodes. Click to select an existing variable or create a new one. The output includes the publish status, mashup ID, and content URL. The AI node and subsequent workflow nodes access results using ${state.data.<variable_name>}. For example, if you name it publish_result, access it as ${state.data.publish_result}.

Test the configuration​

After you configure the Publish Mashup tool, test the workflow to verify correct behavior.

  1. Go to Portal Settings > Chatbot > Agents.

  2. Select the agent associated with your workflow, or create a new agent and assign your workflow.

  3. Open the chatbot interface in the portal.

  4. Enter a query that should trigger publishing. For example:

    • "Publish the onboarding video"
    • "Make this document available to the team"
    • "Publish the training content I uploaded yesterday"

  5. Verify that the agent confirms the publish action and returns the status.

  6. Check that the response includes the mashup ID and URL of the published content.

  7. If results don't match expectations, return to the Workflow Designer and adjust your configuration.

Best practices​

  • Configure the tool description to instruct the AI to confirm user intent before publishing. Publishing is a significant action that should not happen without explicit confirmation.
  • Pair the Publish Mashup tool with the Search Mashup tool or Read Content tool so the AI can first locate the content and then publish it.
  • Use an Approval node in your workflow before the Publish Mashup tool for additional human oversight of publish actions.
  • Ensure that users interacting with the agent have the appropriate publishing permissions in the portal.
Did you find this article helpful?